package cn.tedu.hongbeifang.mapper;
import cn.tedu.hongbeifang.pojo.entity.Banner;
import cn.tedu.hongbeifang.pojo.vo.BannerListItemVO;
import cn.tedu.hongbeifang.pojo.vo.BannerStandardVO;
import org.apache.ibatis.annotations.Param;
import org.springframework.stereotype.Repository;

import java.util.List;

@Repository
public interface BannerMapper {
    /**
     * 插入轮播图数据
     *
     * @param banner 轮播图数据
     * @return 受影响的行数
     */
    int insert(Banner banner);

    /**
     * 批量插入轮播图数据
     *
     * @param banners 轮播图列表
     * @return 受影响的行数
     */
    int insertBatch(List<Banner> banners);

    /**
     * 根据id删除轮播图数据
     *
     * @param id 轮播图id
     * @return 受影响的行数
     */
    int deleteById(Long id);

    /**
     * 根据若干个id批量删除轮播图数据
     *
     * @param ids 若干个轮播图id的数组
     * @return 受影响的行数
     */
    int deleteByIds(Long[] ids);

    /**
     * 根据id修改轮播图数据
     *
     * @param banner 封装了轮播图id和新数据的对象
     * @return 受影响的行数
     */
    int update(Banner banner);

    /**
     * 统计轮播图数据的数量
     *
     * @return 轮播图数据的数量
     */
    int count();

    /**
     * 根据轮播图url统计数据的数量
     *
     * @param url 轮播图url
     * @return 匹配url的轮播图数据的数量
     */
    int countByUrl(String url);

    /**
     * 统计非某id但url匹配的轮播图数据的数量，用于检查是否存在其它数据使用了相同的url
     *
     * @param id   轮播图id
     * @param url 轮播图url
     * @return 匹配名称但不匹配id的数据的数量
     */
    int countByUrlAndNotId(@Param("id") Long id, @Param("url") String url);

    /**
     * 根据id查询轮播图数据详情
     *
     * @param id 轮播图id
     * @return 匹配的轮播图数据详情，如果没有匹配的数据，则返回null
     */
    BannerStandardVO getStandardById(Long id);
    /**
     * 查询轮播图数据列表
     *
     * @return 轮播图数据列表
     */
    List<BannerListItemVO> list();

}
